home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / util / misc / EpicES.lha / EpicES / EpicES.doc < prev    next >
Text File  |  2002-10-05  |  7KB  |  207 lines
  1. EpicES V1.09 (05/10/2002)
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~
  3. This is EpicEncyclopediaSearch V1.09. An alternative search utility for the
  4. wonderful Epic Interactive Encyclopedia '97.
  5.  
  6. EpicES was created using Blitz Basic 2.1.
  7.  
  8. I initially decided to develop this program, because I felt the original
  9. program's search facility lacked the ability to display all matches at once.
  10. The only way to find what you want was to keep pressing the "next" key
  11. combination (ramiga n). Then if you missed the article you were looking for,
  12. you had to repeat the whole process again.
  13.  
  14. I have also noticed that in the directory "Epic_Encyclopedia:Menufiles/
  15. WORLDinfo/", there are text files on 196 countries, but there is no way of
  16. accessing these files from the encyclopedia.
  17.  
  18. As well as that, there are more subjects located in the archive
  19. "Epic_Encyclopedia:Menufiles/Vin-archive/People-MESS.LHA". As the name
  20. suggests, the archive mainly contains information on people. Again, there is
  21. no way of accessing this from the encyclopedia. You could copy the contents
  22. of this archive to your hard disk, but the archive is 2.3M in size, which is
  23. about 7M uncompressed! So why not search the archive whilst compressed! After
  24. all, LhA can list and extract single files from an archive.
  25.  
  26. EpicES gets around all of these problems, and provides a stable Gadtools
  27. interface, for efficient and user-friendly searching.
  28.  
  29.  
  30.  
  31. Features
  32. ~~~~~~~~
  33. EpicES has the following features:
  34.  
  35. * User-definable viewers for text, images, samples, animations and modules.
  36.  
  37. * Pre-definable saves directory (for text only at this stage).
  38.  
  39. * All subjects matching search criteria are displayed and selected from
  40.   a standard listview.
  41.  
  42. * Subject text displayed in the interface via listview.
  43.  
  44. * World-info text is treated in the same way as any other subject.
  45.  
  46. * "People-MESS" archive searchable whilst in LhA form!
  47.  
  48. * User-definable Index file locations.
  49.  
  50.  
  51.  
  52. Interface Guide
  53. ~~~~~~~~~~~~~~~
  54. Here is a quick guide to get you started:
  55.  
  56. Enter your search criteria, which must be one word and no wildcards (But see
  57. To-Do), in to the top-left box.
  58.  
  59. Press return to execute the search.
  60.  
  61. Criteria matches should appear in the listview below the box. Select one and
  62. the subject's text should appear in the listview at the bottom.
  63.  
  64. At the same time, some of the gadgets on the right should activate, allowing
  65. you to view any of them upon clicking. At any time you may save the
  66. text by selecting the "Edit/Save Text" menu.
  67.  
  68. That's all there is to it! You may select any of the other search matches from
  69. the results list, or enter a new search criteria. Any Subject entries with a
  70. WI: prefix means a match has been found in the World Info directory on the
  71. CD. These subjects are treated in the same way as the main subjects.
  72.  
  73. If no matches appear, enable "Use WorldInfo" and/or "Use People-Mess" from
  74. the Settings menu if you haven't done so already, and search again. Use these
  75. especially if you are searching for a particular person or country.
  76.  
  77. Note: Searching the "People-Mess" archive may take some time.
  78.  
  79.  
  80.  
  81. Settings
  82. ~~~~~~~~
  83. Viewers: 
  84.  
  85. Clicking on the textgadgets on the right of the window brings up a file
  86. requester for you to select an appropriate viewer for the type of file.
  87.  
  88. The selected viewer will appear in the string gadget to the left, allowing
  89. you to put in any arguments the viewer can accept. Please leave a space
  90. between the viewer name and it's arguments.
  91.          
  92. The default viewers are all on the encyclopedia disk, but have single letters
  93. for names for some reason. These are copied to your hard disk upon
  94. installation of the encyclopedia, and are renamed to their proper names.
  95.  
  96. Here is a list of the viewers used along with their "proper names".
  97.  
  98. B- DSound        Sound player by Dave Schreiber.
  99. E- Noiseplayer   Music module player. Use -m1 for argument by Jolyon Ralph.
  100. F- Play16        Sound sample player by Thomas Wenzel.
  101. L- Visage        Picture viewer by Magnus Holmgren.
  102. M- VT            Picture viewer and animation player by Thomas Krehbiel.
  103.  
  104. For viewing text: more, multiview or a word processor may be used as well as
  105. EpicES's listview.
  106.  
  107. Stefan Boberg's LhA is also located in this directory and is used by EpicES
  108. to extract files from the People-MESS.lha archive.
  109.  
  110.  
  111. Index Files:
  112.  
  113. Select the index files by clicking on the buttons to the right of the
  114. string gadgets.
  115.  
  116. The default location for the index files is in the "Menufiles/Indexfiles/"
  117. directory.
  118.  
  119. The World Info files are in the "Menufiles/WORLDinfo/" directory.
  120.  
  121. Last, but not least, the People-MESS archive can normally be found in
  122. "Menufiles/Vin-archive/".
  123.  
  124.  
  125. Font:
  126.  
  127. Select the 8x8 font to be used throughout the interface and menus.
  128.  
  129.  
  130.  
  131. Troubleshooting.
  132. ~~~~~~~~~~~~~~~~
  133. In this section I have listed some problems along with possible solutions.
  134. But if you are still having problems, please don't hesitate to report them
  135. to me at silverscope@connectfree.co.uk, and I will do my best to fix them.
  136.  
  137. * If you are unable to view any of the multi-media files associated with
  138.   a subject, even if the gadgets are active, then check the viewers settings
  139.   ("Settings/Viewers" menu). The default ones should be on the CD.
  140.  
  141.  
  142.  
  143. DISCLAIMER
  144. ~~~~~~~~~~
  145. This program is freeware, so no donations are required.
  146. Redistribution is allowed if the package is left unchanged.   
  147. The author is not responsible for any damage caused by the use of this
  148. program.
  149.  
  150.  
  151.  
  152. To-Do
  153. ~~~~~
  154. > Saving of all data.
  155.  
  156. > Viewing of anims with sound.
  157.  
  158. > Wildcard support for search string.
  159.  
  160.  
  161.  
  162. History
  163. ~~~~~~~
  164. V1.02 -    Added infotext listview. Viewers support. States when searching
  165.     begins and ends.
  166.  
  167. V1.03 -    Gadgets expand/move to accomadate window size.
  168.  
  169. V1.04 -    Added "Interact" button. Changed gadget layout. Seperated viewer
  170.     strings.
  171.     Fixed Gadget refresh after window resize problems.
  172.     States number of subject entries found.
  173.     Now only finds animation without sound.
  174.  
  175. V1.05 -    Added menus:- About, Quit, Copy text, Index files, Viewers, save
  176.     settings.
  177.     Implemented About requester and quit menu item.
  178.     Index files prefs window added. All functioning.
  179.  
  180. V1.06 -    Visual Prefs support added to main window.
  181.     Save Settings routine implemented.
  182.     Added "Font" menu item.
  183.     8x8 font can now be loaded for the GUI and menus. Font saves.
  184.  
  185. V1.07 -    Implemented WorldInfo search and view with textwrap.
  186.     Fixed error upon failing to read index files.
  187.     Merged hdindex search with cdindex search.
  188.     "Save Text" menu item saves to pre-defined directory.
  189.     "Viewers" menuitem changed to "Save Path".
  190.     "Save Path" now works.
  191.  
  192. V1.08 -    Added "Viewers" settings window - fully functional for all 5 viewers.
  193.     Added viewers to save list.
  194.     WorldInfo Directory selector added to Index files prefs window.
  195.     Index files prefs window functionality now same as that of viewers
  196.     prefs; String gadget reflects new setting after "OK" is pressed in 
  197.     the file requester, and string gadget may be used to alter the file
  198.     path.
  199.     Added version string to about requester.
  200.  
  201. V1.09 -    Implemented "People-MESS" search. Using "Lha vq" to list the
  202.     found items, and "Lha e" to extract the subject"s infotext.
  203.     Added "Use People-Mess" and " Use WoldInfo" menu items so that
  204.     searching of these can be de-activated for speed.
  205.     Added LhA to "Viewers" and "People-MESS" archive location to Index
  206.     files prefs. Uploaded (05/10/02).
  207.